home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat2 / standard / setspinfo.z / setspinfo
Encoding:
Text File  |  1998-10-20  |  4.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. sssseeeettttssssppppiiiinnnnffffoooo((((2222))))                                                      sssseeeettttssssppppiiiinnnnffffoooo((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      setspinfo - set service provider information
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////eeeexxxxttttaaaacccccccctttt....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<uuuunnnniiiissssttttdddd....hhhh>>>>
  14.  
  15.      iiiinnnntttt sssseeeettttssssppppiiiinnnnffffoooo((((ssssttttrrrruuuucccctttt aaaacccccccctttt____ssssppppiiii ****ssssppppiiii))));;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      The _s_e_t_s_p_i_n_f_o function sets the service provider information for the
  19.      array session containing the current process to the contents of the
  20.      aaaacccccccctttt____ssssppppiiii struct pointed to by _s_p_i.  Typically, this would only be done
  21.      when the array session is first created.  The invoker must have superuser
  22.      privileges.
  23.  
  24.      Service provider information is intended for use by software such as
  25.      batch queueing systems that need to maintain fairly static information
  26.      about an array session.  It is included in session accounting records and
  27.      can be retrieved by any member of the array session.  Ordinarily, the
  28.      service provider information for a new array session is inherited from
  29.      the array session of the process that created it; _s_e_t_s_p_i_n_f_o can be used
  30.      to override this default behavior.
  31.  
  32.      The service provider information itself has no particular meaning to
  33.      IRIX.  For convenience, a suggested aaaacccccccctttt____ssssppppiiii struct is defined in the
  34.      <_s_y_s/_e_x_t_a_c_c_t._h> header file and has the following layout:
  35.  
  36.           struct acct_spi {       /* Service provider information */
  37.               char    spi_company[8];    /* Name of company providing service */
  38.               char    spi_initiator[8];  /* Name of machine initiating job */
  39.               char    spi_origin[16];    /* Name of queue */
  40.               char    spi_spi[16];       /* Available for service provider */
  41.               char    spi_spare[16];     /*   reserved */
  42.           }
  43.  
  44.  
  45.      _s_e_t_s_p_i_n_f_o is provided primarily for compatibility with older versions of
  46.      IRIX.  A more general mechanism for setting the service provider
  47.      information, including the ability to save more or less than the 64 bytes
  48.      of data implied by aaaacccccccctttt____ssssppppiiii, is provided by the AAAARRRRSSSSOOOOPPPP____SSSSEEEETTTTSSSSPPPPIIII function of
  49.      _a_r_s_o_p(2).
  50.  
  51. EEEERRRRRRRROOOORRRRSSSS
  52.      _s_e_t_s_p_i_n_f_o may fail if one or more of these conditions are true:
  53.  
  54.      EEEEFFFFAAAAUUUULLLLTTTT    _s_p_i points to an invalid location.
  55.  
  56.      EEEEPPPPEEEERRRRMMMM     The current process does not have superuser privileges.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sssseeeettttssssppppiiiinnnnffffoooo((((2222))))                                                      sssseeeettttssssppppiiiinnnnffffoooo((((2222))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      arsop(2), getspinfo(2), newarraysess(2), array_sessions(5), extacct(5).
  76.  
  77. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  78.      Upon successful completion, _s_e_t_s_p_i_n_f_o returns a value of 0.  Otherwise, a
  79.      value of -1 is returned and eeeerrrrrrrrnnnnoooo is set to indicate the error.
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.